home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Monster Media 1996 #15
/
Monster Media Number 15 (Monster Media)(July 1996).ISO
/
syncrnet
/
ezadr223.zip
/
EASYADD.DOC
< prev
next >
Wrap
Text File
|
1996-06-07
|
17KB
|
333 lines
┌───────────────────────────────────────────────────────────────────────────┐
│ Copyright Notice and Program Disclaimer │
└───────────────────────────────────────────────────────────────────────────┘
This software is Copyright 1995 and owned by G.A.C. Computer Services.
G.A.C. Computer Services grants to the user a nonexclusive license to use
this software solely for its internal business purposes. The user may not
commercially distribute, sublicense, resell, or otherwise transfer for any
consideration, or reproduce for any such purposes, the software or any
modification or derivation thereof, either alone or in conjunction with any
other product or program. Further, the user may not modify the software or
its support files for any purpose.
THIS SOFTWARE IS PROVIDED TO THE USER ''AS IS.'' G.A.C. COMPUTER SERVICES
MAKES NO WARRANTIES, EITHER EXPRESS OR IMPLIED, WITH RESPECT TO THIS
SOFTWARE AND/OR ASSOCIATED MATERIALS PROVIDED TO THE USER, INCLUDING
BUT NOT LIMITED TO ANY WARRANTY OF MERCHANTABILITY, FITNESS FOR A
PARTICULAR PURPOSE OR AGAINST INFRINGEMENT. G.A.C. COMPUTER SERVICES DOES
NOT WARRANT THAT THE FUNCTIONS CONTAINED IN THE SOFTWARE WILL MEET YOUR
REQUIREMENTS, OR THAT THE OPERATION OF THE SOFTWARE WILL BE
UNINTERRUPTED OR ERROR-FREE, OR THAT DEFECTS IN THE SOFTWARE WILL BE
CORRECTED. FURTHERMORE, G.A.C. COMPUTER SERVICES DOES NOT WARRANT OR MAKE
ANY REPRESENTATIONS REGARDING THE USE OR THE RESULTS OF THE USE OF THE
SOFTWARE OR ANY DOCUMENTATION PROVIDED HEREWITH IN TERMS OF THEIR
CORRECTNESS, ACCURACY, RELIABILITY, OR OTHERWISE. NO ORAL OR WRITTEN
INFORMATION OR ADVICE GIVEN BY G.A.C. COMPUTER SERVICES OR A G.A.C. COMPUTER
SERVICES AUTHORIZED REPRESENTATIVE SHALL CREATE A WARRANTY OR IN ANY WAY
INCREASE THE SCOPE OF THIS WARRANTY.
LIMITATION OF LIABILITY -- G.A.C. COMPUTER SERVICES AND ITS LICENSORS ARE
NOT LIABLE FOR ANY CLAIMS OR DAMAGES WHATSOEVER, INCLUDING PROPERTY DAMAGE,
PERSONAL INJURY, INTELLECTUAL PROPERTY INFRINGEMENT, LOSS OF PROFITS, OR
INTERRUPTION OF BUSINESS, OR FOR ANY SPECIAL, CONSEQUENTIAL OR
INCIDENTAL DAMAGES, HOWEVER CAUSED, WHETHER ARISING OUT OF BREACH OF
WARRANTY, CONTRACT, TORT (INCLUDING NEGLIGENCE), STRICT LIABILITY, OR
OTHERWISE.
┌───────────────────────────────────────────────────────────────────────────┐
│ List of included files in the Archive │
└───────────────────────────────────────────────────────────────────────────┘
EASYADD.EXE - The Main executable
EASYADD.DOC - This Documentation file
ADDRESS.SAM - Sample file of new address book addresses
EASYUP.EXE - Program to Update V 1.0 USER files to V 2.0+ format
FILE_ID.DIZ - A short description of Easy Address
REGISTER.DOC - A Registration form for G.A.C. Computer Services
Products.
UPGRADE.DOC - Step by Step Upgrade Instructions for SysOps
HISTORY.DOC - File explaining what has changed in Easy Address
NOTE: EASYADD will make MANY small files when it executes.
EZ[#].ADD - These files are created for each user in the Easy
Address directory
EASY[#].BIN - These files are created in the SBBS\EXEC directory
┌───────────────────────────────────────────────────────────────────────────┐
│ Description of Easy Address TM │
└───────────────────────────────────────────────────────────────────────────┘
NOTE: THIS PROGRAM SHOULD ONLY BE USED WITH SYNCHRONET 2.1 AND UP!
This program is quite possibly one of the best utilities written for
Synchronet. It is an address book for use with Internet E-mail,
QWK Netmail, and/or Fidonet NetMail. It should make the sysop's and
users' experience with NetMail much easier and faster. No longer do
you have to type in long or hard to remember e-mail addresses, rather
you and your users will store those addresses in your personal e-mail
address book.
Easy Address was written with the Synchronet XSDK and Open Doors
programming libraries. It has been tested and is in use all over
the world. Easy Address is now easier to setup than ever before thanks
to a built-in configuration program, and it has all of the features that
SysOps expect to find in a well built program.
Some of it's greatest features are:
- an easy to use configuration program
- allows users to address e-mail messages with one keystroke
- Supports internet<->fidonet gateways (GUUCP) automatically with no
effort on the part of the user or SysOp.
- allows users to store hundreds of addresses with personalized
notes about each address (if the he/she desires)
- allow SysOps to configure a file of default addresses that are
loaded into the users address book the first time they use Easy
Address.
- allows SysOps to customize the colors used in the program
As you can see Easy Address is an excellent addition to any Synchronet
BBS System.
┌───────────────────────────────────────────────────────────────────────────┐
│ Installation of Easy Address │
└───────────────────────────────────────────────────────────────────────────┘
To set up Easy Address follow the instructions given below. They include
setting up Easy Address in the SCFG configuration program, and using the
CONFIG command line parameter to configure Easy Address.
NOTE: - Easy Address requires BAJA.EXE to be in the EXEC directory.
- If you experience difficulties running Easy Address as an
external program due to a BAJA problem, or file not found, see
Optional Setup to Incorporate Easy Address into the NetMail Menu.
Simply follow the additional steps and your problem should be
solved, feel free to conatact us with any questions.
1. Create a directory for EASY ADDRESS
e.g. mkdir c:\sbbs\xtrn\easyadd <ENTER>
2. Copy ALL of the archive files to this directory.
e.g. copy *.* c:\sbbs\xtrn\easyadd <ENTER>
3. Use the CONFIG parameter to run the Easy Address configuration
e.g. EASYADD CONFIG <ENTER>
Most options are self-explanatory, but the following need to be
remembered when configuring Easy Address:
- The internet option must be one of the following:
The FULL fidonet gateway (GUUCP) address that you use to send
internet e-mail e.g. 1:13/10 If you do not know about
GUUCP addresses, look in the archive GUUCP.ARJ for more
information.
SUUCP - if you are using NetXpress or a similiar software
package to perform UUCP transfers.
NONE - if you want to diable the internet e-mail option.
- The timezone variable is needed so Easy Address can
accurately display the current date and time to the user.
This is the same variable used by TICK and many other
bbs-related programs. It represents the difference in hours
between your location and Greenwhich Mean Time (GMT). For
the Eastern time zone, it would be set to TZ=EST5EDT.
Central Time Zone is TZ=CST6EDT, and Pacific is PST8EDT.
- The configuration options that allow you to specify what your
fidonet, internet or QWK e-mail addresses require that you
ONLY specify the domain portion of the addresses, and NOT
include a user name. Easy Address will display the users
name where appropriate.
e.g. I would just use 1:124/8047 for my fidonet address
4. Go into SCFG->External Programs->External Programs and add two
external programs (EASYADD and EASYADDF, see example below) to
your external program groups. These will allow your users to
use the Easy Address book to send NetMail and File Attaches.
╔[■][?]════════════════════════════════════════════════════╗
║ EASYADD ║
╠══════════════════════════════════════════════════════════╣
║ │Name Use Easy Address for NetMail ║
║ │Internal Code EASYADD ║
║ │Start-up Directory C:\SBBS\XTRN\EASYADD ║
║ │Command Line EASYADD EMAIL ║
║ │Clean-up Command Line *EASY%# ║
║ │Cost in Credits 0 ║
║ │Extra Minutes 0 ║
║ │Suspended (Free) Time No ║
║ │Access Requirements ║
║ │Execution Requirements ║
║ │Multiple Concurrent Users Yes ║
║ │Intercept I/O Interrupts Yes ║
║ │Swap BBS out of Memory Yes ║
║ │Modify User Data No ║
║ │Execute on Event No ║
║ │BBS Drop File Type Synchronet XTRN.DAT ║
║ │Place Drop File In Node Directory ║
╚══════════════════════════════════════════════════════════╝
AND
╔[■][?]════════════════════════════════════════════════════╗
║ EASYADDF ║
╠══════════════════════════════════════════════════════════╣
║ │Name Use Easy Address for Sending Files ║
║ │Internal Code EASYADDF ║
║ │Start-up Directory C:\SBBS\XTRN\EASYADD ║
║ │Command Line EASYADD FILE ║
║ │Clean-up Command Line *EASY%# ║
║ │Cost in Credits 0 ║
║ │Extra Minutes 0 ║
║ │Suspended (Free) Time No ║
║ │Access Requirements ║
║ │Execution Requirements ║
║ │Multiple Concurrent Users Yes ║
║ │Intercept I/O Interrupts Yes->No to WWIV ║
║ │Swap BBS out of Memory Yes ║
║ │Modify User Data No ║
║ │Execute on Event No ║
║ │BBS Drop File Type Synchronet XTRN.DAT ║
║ │Place Drop File In Node Directory ║
╚══════════════════════════════════════════════════════════╝
┌───────────────────────────────────────────────────────────────────────────┐
│ Optional Setup to Create a Custom List of Addresses for Your Users │
└───────────────────────────────────────────────────────────────────────────┘
The file ADDRESS.SAM is included in the Easy Address archive. This
file needs to be copied to ADDRESS.DAT to be used with Easy Address.
If the file ADDRESS.DAT does not exist, then users will be given two
default addresses for their address book, these addresses are my
Fidonet and Internet addresses.
The file ADDRESS.DAT may contain as many addresses and notes about
the addresses as you want to include. This is an excellent way for
you as SysOp to get your users familiar with NetMail. The file must
follow a simple, but strict format, that is one line for the address
and the next line for the note about that address. If this format
is not followed, your users will have a mixed up address book.
e.g.
Gregory Campbel@1:124/8047 (1st line)
Author's Fidonet Address (2nd Line)
campbel@onramp.net (3rd Line)
Author's Internet Address (4th Line)
noname@company.net (5th Line)
None (6th Line)
As you can see above, if you do not want to enter a note about an
address, simply put the word None on that line (as in line 6).
Save the file, and the next user that enter's Easy Address for the
FIRST time will receive your list of addresses.
┌───────────────────────────────────────────────────────────────────────────┐
│ Optional Setup to Incorporate Easy Address into the NetMail Menu │
└───────────────────────────────────────────────────────────────────────────┘
The way I prefer to run Easy Address on my system is to have it
incorporated into my NetMail menu. If you are familiar with the
BAJA language, the following modifications will be simple, if you
are not, please read the BAJA.DOC file in your SBBS\DOCS directory
before attempting the following modifications (or at least back
up your currect .SRC files).
1. Modify each of your BAJA source files (.SRC) as follows:
e.g. Edit DEFAULT.SRC
Replace the command MAIL_SEND_NETMAIL with:
EXEC_XTRN EASYADD
EXEC *EASY%#
and replace the command MAIL_SEND_NETFILE with:
EXEC_XTRN EASYADDF
EXEC *EASY%#
2. Compile the modified source files
e.g. BAJA DEFAULT.SRC <ENTER>
3. Load up Synchronet SCFG and delete the clean up command line for
EASYADD and EASYADDF external programs, also change the access
requirements of the EASYADD and EASYADDF external programs to
LEVEL 99 and they won't even show up to your users. This way the
intergration of Easy Address is complete and invisible to your
users.
┌───────────────────────────────────────────────────────────────────────────┐
│ Optional Setup to Use the Internet<->Fidonet Gateway at 1:13/10 (GUUCP) │
└───────────────────────────────────────────────────────────────────────────┘
GUUCP is a flag given to certain fidonet systems which designates them
as liasons between the internet and fidonet. These systems allow
fidonet users to send e-mail to and receive e-mail from the internet.
To use the GUUCP gateway, you must first be running a fidonet compatible
system and be listed in the fidonet nodelist. It is also important
that you understand the rules of the gateway.
If you decide that you want to use Easy Address with this gateway to
send and receive internet e-mail, you will have to register at the
gateway. You also need to note that all of your incoming internet
e-mail will be placed on HOLD for you and you must poll the system
at 1:13/10 to pick up the e-mail at least twice a week, but the
gateway use is free.
To setup Easy Address to use this gateway, do the following:
- File Request FAQ from 1:13/10 and read all the files.
- File Request REGISTER from 1:13/10 to register your system
with the gateway server.
- Setup your system to poll 1:13/10 twice a week (or more).
- Run EASYADD CONFIG
- Place 1:13/10 in the internet option (this is your
full GUUCP address)
- Place your assigned internet domain address where
the config program asks.
That's it, there is no need for your users to worry about how to
address the internet messages, as long as they use valid internet
addresses. Easy Address will make sure the e-mail is sent through
the gateway in the correct format.
┌───────────────────────────────────────────────────────────────────────────┐
│ Registration and technical support │
└───────────────────────────────────────────────────────────────────────────┘
Registration cost is $10.00 U.S. for Easy Address
See the enclosed REGISTER.DOC file for instructions on how to
register.
For technical support, bug reports, comments AND suggestions please
contact me in one of the following ways:
Send me NetMail: Gregory Campbell@1:124/8047
Send me Internet E-mail: campbel@onramp.net
World Wide Web: http://rampages.onramp.net/~campbel/
Call my BBS: 214-527-6811 (login as Guest)
Call me voice: 214-517-3692 (10am-9pm CST, M-F)
Or Ask me a question On Synchronet SysOps in DOVE-Net, my Alias
is The.Tramp
┌───────────────────────────────────────────────────────────────────────────┐
│ Acknowledgements │
└───────────────────────────────────────────────────────────────────────────┘
Special thanks go to all those people that helped with the alpha
and beta testing of this product. Specifically the following people
need to be acknowledged:
Rob Swindell - For creating Synchronet and the XSDK.
Brian Pirie - For creating the Open Doors library of functions,
distributing and selling it as shareware.
Easy Address is a trademark of G.A.C. Computer Services